home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 010a / chkback.zip / CHKBACK.DOC next >
Text File  |  1990-11-22  |  11KB  |  246 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                  ┌───────────────────────────────────────────┐
  7.                  │  CHKBACK - CHECK BACKUP DISKETTE CONTENTS │
  8.                  │         D O C U M E N T A T I O N         │
  9.                  └───────────────────────────────────────────┘
  10.  
  11.  
  12.                            Hutchins Software
  13.                            5323 West Townley Avenue
  14.                            Glendale, AZ  85302
  15.  
  16.                                 Copyright
  17.                               November 1990
  18.                                      
  19.  
  20.  
  21. WHAT CHKBACK DOES
  22.  
  23. This program was written quickly in my spare time to examine DOS 3.3 and 4.0
  24. backup diskettes and produce a list of files from those diskettes.  Prior to
  25. DOS 3.3, during backup, each file that was backed up was placed on a diskette 
  26. along with BACKUPID.@@@.  You could issue the DOS DIR command and see what was 
  27. on a backup diskette.  With DOS 3.3 and 4.0 only two files are on each backup 
  28. diskette.  The DIR command only shows the two files BACKUP.nnn and CONTROL.nnn 
  29. (where nnn = sequence number of diskette).  
  30.  
  31. The file BACKUP.nnn is a concatenation of all the files backed up on the 
  32. diskette and CONTROL.nnn contains the directory and files names and other file 
  33. information.  CONTROL.nnn can be looked at to see what the directory and file 
  34. names are, but it is difficult to read the information.  CHKBACK filters out 
  35. the garbage in CONTROL.nnn and shows you the directory and files names.
  36.  
  37. With DOS Backup you can use the "logging" option to produce a list of what is
  38. backed up, but you might forget to do this or might lose the printed log.
  39. CHKBACK is designed for those times that you don't have a log available and
  40. don't want to have to restore to find out what a backup diskette contains.
  41.  
  42. HOW CHKBACK WORKS
  43.  
  44. About 80% of the filtering of CONTROL.nnn is accomplished by calling (from
  45. CHKBACK) a program called CHK4BOMB, which is part of a program package known 
  46. as BOMBSQAD.  The BOMBSQAD program code is owned by Andy Hopkins Swathmore 
  47. Software Systems and is not part of this program.  According to the BOMBSQAD 
  48. documentation, the program may be copied freely.  BOMBSQAD is not included
  49. with CHKBACK because it is not part of CHKBACK.  CHKBACK could be considered
  50. as an "add on" to BOMBSQAD.  Note that only the CHK4BOMB.EXE program is needed
  51. for operation of CHKBACK.  You will need a copy of CHK4BOMB.EXE in order to use
  52. CHKBACK.  BOMBSQAD and CHK4BOMB are available on most bulletin boards. CHKBACK
  53. has only been tested with Version 1 of CHK4BOMB.  The CHK4BOMB.EXE file is
  54. dated 7-29-86 and is 12,032 bytes in size.  I haven't seen any update since
  55. then, so most everyone will have the same version of CHK4BOMB.
  56.  
  57. DETAILS OF OPERATION
  58.  
  59. CHKBACK always writes one temporary file (called CHKBACK.TMP) to the current 
  60. drive and directory.  Upon a proper exit from the program, this file is 
  61. deleted.  The program also writes a file called TEMP.LST if the "display" 
  62. option is selected.  If the "file" option is selected, the program writes 
  63. to a file name (and optionally a drive and/or path) specified by you.  This 
  64. file is left on your disk upon exit from the program, so that you may edit 
  65. it, examine it or print it with your own favorite utility.   The program will 
  66. check to see if  TEMP.LST or a file that you specified exists first before 
  67. overwriting, but does not check to see if CHKBACK.TMP exists before 
  68. overwriting that file.
  69.  
  70. INSTALLATION
  71.  
  72. CHKBACK is intended use on a hard disk based system.  Copy CHKBACK.EXE to
  73. to any directory that you desire on your hard disk.  If you want to be able 
  74. to use CHKBACK at all times, be sure to copy it to a directory that is in the 
  75. DOS path.  In addition to CHKBACK.EXE, you will need a copy of CHK4BOMB.EXE,
  76. mentioned previously.   CHKBACK.DOC can be copied to the hard disk if you want 
  77. to keep the documentation too.  
  78.  
  79. For best results in using CHKBACK or if you have difficulty, it is strongly
  80. recommended  that you must use the DOS ANSI.SYS driver.  To use it, place the 
  81. ANSI.SYS device driver line in your CONFIG.SYS file.  How this line looks will 
  82. depend on where you keep ANSI.SYS.  ANSI.SYS comes with DOS and should be in 
  83. the same directory as DOS.  If DOS resides in a directory called DOS, the 
  84. device driver line in CONFIG.SYS should look like this:
  85.  
  86.                   DEVICE=\DOS\ANSI.SYS
  87.                   or
  88.                   DEVICE=C:\DOS\ANSI.SYS
  89.  
  90. For some reason (which I have never quite been able to figure out), some people
  91. copy their ANSI.SYS driver to the root directory, in which case they use one 
  92. of the following:
  93.  
  94.                   DEVICE=ANSI.SYS
  95.                   or
  96.                   DEVICE=\ANSI.SYS
  97.                   or
  98.                   DEVICE=C:\ANSI.SYS
  99.  
  100. This was probably done by installers who didn't understand pathing or perhaps
  101. early versions of DOS didn't support the path in device statements?
  102.  
  103. CHKBACK FILES
  104.  
  105. NAME:            SIZE:  DATE:     TIME:     USE:
  106. ----------------------------------------------------------
  107. CHKBACK  EXE     5044   8-12-90   4:16p     MAIN PROGRAM
  108. CHKBACK  DOC     3761   8-12-90   4:54p     DOCUMENTATION
  109. CHK4BOMB EXE    12032   7-29-86             NOT INCLUDED - SEE DOCUMENTATION
  110.  
  111. HOW TO USE CHKBACK
  112.  
  113. To use CHKBACK simply insert a diskette in any diskette drive and enter
  114. CHKBACK.  You'll then be asked to enter a diskette drive.  Enter a drive,
  115. including the colon.  
  116.  
  117. If you forget the colon, this error message appears:
  118.  
  119.      DRIVE ENTERED INCORRECTLY!  
  120.      ENTER DRIVE LETTER, FOLLOWED BY A COLON, SUCH AS:  A: B: E: 
  121.      TRY AGAIN!
  122.  
  123. After you enter a drive letter and colon, the following appears:
  124.     
  125.      P=Print, D=Display, S=Save to Disk File:
  126.  
  127. If you want to print the results make sure your printer is ready to print and
  128. enter a "P".  If you want to display the results, enter a "D".  If you want
  129. to save the results to a disk file enter "S".  If you don't enter a "P", "D"
  130. or "S", this message appears:
  131.     
  132.      INCORRECT RESPONSE! ENTER P, D OR S
  133.      TRY AGAIN!
  134.  
  135. If you enter "S" to save to a disk file the following appears:
  136.  
  137.      ENTER NAME OF OUTPUT FILE (Including drive and/or path if desired):
  138.      
  139. Enter a name of a file for the program to use in saving the information that
  140. you want.  You can also enter a drive and/or path if you wish.  In the unlikely
  141. event that you should choose to name the file TEMP.LST, the following message
  142. will appear:
  143.  
  144.      SORRY, BUT "TEMP.LST" IS THE ONLY NAME YOU CANNOT USE.  TRY AGAIN.
  145.  
  146. If you just press enter through the name, the following appears:
  147.  
  148.      YOU MUST ENTER A NAME!  TRY AGAIN.
  149.  
  150. If you enter the name of a file that already exists, this message appears:
  151.  
  152.      WARNING:
  153.      
  154.      You already have a file called xxxxxxxx.
  155.      Press ENTER to continue (will delete xxxxxxxx and continue)
  156.      or press CTRL/BREAK to quit.
  157.  
  158. This tells you that you are trying to use a file that already exists.  If you
  159. don't mind losing what is in that file, press enter to continue the program;
  160. otherwise, press CTRL/BREAK to exit, so that you can start again.
  161.  
  162. If you choose "D" for display and you happen to have a file called TEMP.LST in
  163. the current directory, CHKBACK will display the following message:
  164.  
  165.      WARNING:
  166.  
  167.      This program uses a temporary file called TEMP.LST, but you have a file
  168.      with that name.  Press ENTER to continue (will delete TEMP.LST and 
  169.      continue) or press CTRL/BREAK to quit.
  170.  
  171. This tells you that if you continue, the file TEMP.LST will be reused.  If 
  172. it is a valid file on your system, you may not want to do this.  CTRL/BREAK
  173. to quit; then temporarily rename TEMP.LST.  Then run CHKBACK.  After CHKBACK
  174. is complete, rename TEMP.LST back to its' original name.  Note that a
  175. previous session of CHKBACK might have left TEMP.LST on your system.  When
  176. CHKBACK runs to completion, it automatically deletes TEMP.LST, but if you
  177. hit CTRL/BREAK or if you lose power before CHKBACK is done, TEMP.LST might
  178. get left on your system.  
  179.  
  180. Once everything has been entered correctly, this message appears:
  181.      
  182.      READING DISKETTE. PLEASE WAIT ...
  183.  
  184. Then you may also see this message:
  185.  
  186.      WRITING TEMPORARY WORK FILE TO HARD DISK.  PLEASE WAIT ...
  187.  
  188. If you selected the print option, you will see this message:
  189.  
  190.      PRINTING ...
  191.  
  192. If you decided to write to a diskette file, you'll see this message: 
  193.  
  194.      WRITING DISKETTE CONTENTS TO "xxxxxxxx".  PLEASE WAIT ...
  195.  
  196. and then after the writing is complete, this message:
  197.  
  198.      YOUR LIST OF FILES FOR THIS DISKETTE IS IN: "xxxxxxxx"
  199.  
  200. If you selected the display option, this message will appear after the 
  201. diskette has been processed:
  202.   
  203.      This is diskette number 'nn' in your backup set.
  204.  
  205.      Press enter to see list of files on the diskette.
  206.  
  207. After each screen full of files shows, the screen will stop and wait for you
  208. to press a key and the word "MORE" will appear at the bottom.  
  209.  
  210. SHORTCUTS AND TIPS
  211.  
  212. To keep the initial screen from displaying, you can enter CHKBACK with a drive
  213. option, such as:    
  214.                      CHKBACK A:
  215.  
  216. Using the CTRL/BREAK key will cause a return to DOS from anywhere within 
  217. CHKBACK.  Use CTRL/BREAK if you change your mind at any point.  This may leave
  218. the file TEMP.LST on your drive if you selected the display option.
  219.  
  220. LICENSE AND REGISTRATION
  221.  
  222. This program is copyrighted by Hutchins Software.  It may be copied and
  223. used freely for evaluation purposes only.  It can not be used as part 
  224. a commercial package or sold.  You may use the program as many times as 
  225. you wish for evaluation purposes, but if you like the program and use it
  226. regularly, you are expected to register.  Full registration entitles you 
  227. to your own diskette with serial number and printed documentation and
  228. support.  All support questions must be submitted in writing in the
  229. first 90 days after registration.  Registered users will be kept up-to-date 
  230. on future shareware products from Hutchins Software.  To order full 
  231. registration, send $5 with your name and address to Hutchins Software, 
  232. 5323 West Townley Avenue, Glendale, AZ 85302.  Please specify diskette size.
  233.  
  234. Every attempt has been made to produce a product that works as represented;
  235. however,  your use of this software constitutes acceptance of it, as is,
  236. without any warranty of merchantability or fitness for a particular 
  237. purpose, performance or otherwise; all warranties are expressly disclaimed.  
  238. By using CHKDSK, you agree that neither Hutchins Software, nor any officers, 
  239. directors, employees or owners of the company will be liable to you or any 
  240. third party for any damages whatsoever.
  241.  
  242. All usage of BOMBSQAD is controlled by the owner of that program, Andy
  243. Hopkins.  Hutchins Software has no connection with Andy Hopkins and does not
  244. distribute BOMBSQAD and is in no way responsible for it or how it may operate
  245. in connection with CHKBACK.
  246.